home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / general / hdf / unix / hdf3_2r2.lha / HDF3.2r2 / README.VMS < prev    next >
Encoding:
Text File  |  1992-09-08  |  2.5 KB  |  56 lines
  1. #***************************************************************************
  2. #
  3. #
  4. #                         NCSA HDF version 3.2
  5. #                            August 28, 1992
  6. #
  7. # NCSA HDF Version 3.2 source code and documentation are in the public
  8. # domain.  Specifically, we give to the public domain all rights for future
  9. # licensing of the source code, all resale rights, and all publishing rights.
  10. #
  11. # We ask, but do not require, that the following message be included in all
  12. # derived works:
  13. #
  14. # Portions developed at the National Center for Supercomputing Applications at
  15. # the University of Illinois at Urbana-Champaign, in collaboration with the
  16. # Information Technology Institute of Singapore.
  17. #
  18. # THE UNIVERSITY OF ILLINOIS GIVES NO WARRANTY, EXPRESSED OR IMPLIED, FOR THE
  19. # SOFTWARE AND/OR DOCUMENTATION PROVIDED, INCLUDING, WITHOUT LIMITATION,
  20. # WARRANTY OF MERCHANTABILITY AND WARRANTY OF FITNESS FOR A PARTICULAR PURPOSE
  21. #
  22. #***************************************************************************
  23.  
  24. VMS has several different file organizations, two of which are 
  25. important to us: the 512-byte Fixed-length record format, and 
  26. the Stream-LF format.  HDF is written in C, and VMS C works (only) 
  27. with the Stream-LF format.  FTP and other transfer programs, on 
  28. the other hand, work better with the Fixed-512 format.  Therefore
  29. HDF includes the FIXATR utility written at NCSA for converting 
  30. between the formats.
  31.  
  32. The files in util/fixatr may be transferred to a VMS system, and compiled
  33. by running the COM file.  Then the command FIXATR may be invoked to convert
  34. files, as in the examples below:
  35.  
  36.     To convert from Fixed-512 to Stream-LF:
  37.         FIXATR myfile.dat /rfm=stream:lf
  38.  
  39.     To convert from Stream-LF to Fixed-512:
  40.         FIXATR myfile.dat /rfm=fixed:512
  41.  
  42. Note that the conversion is done in-place (a new version is not created).
  43.  
  44. Thus, if you FTP a file from the Cray to VMS, you should issue the first
  45. command above, then use HDF calls on it.  On the other hand, if you create a
  46. file on VMS using HDF, you should use the second command to convert it to a
  47. form where you can use FTP or other file transfer programs on it.
  48.  
  49. Actually, the current version of the source code will read Fixed-512 files
  50. also correctly.  However, it creates Stream-LF files, and it is generally
  51. recommended that you convert files to Stream-LF before using HDF on them.
  52.  
  53. Note about setting up fixatr:  You need to edit the file FIXATR.CLD to
  54. change the reference to "disk:directories" to what is on your system,
  55. then type "set command fixatr."
  56.